home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1997 January: Mac OS SDK / Dev.CD Jan 97 SDK2.toast / Development Kits (Disc 2) / OpenDoc Development Framework / Documentation / Engineering Notes / Printing Changes < prev    next >
Encoding:
Text File  |  1996-09-18  |  2.7 KB  |  53 lines  |  [TEXT/ttxt]
  1. OpenDoc
  2. Development
  3. Framework
  4.                                                                                                                                                                                      
  5. Printing Changes 
  6. ODF Release 2                                                                                                                                                             
  7.  
  8.  
  9. The following API changes affect printing in ODF.  For an example of how these methods may be used, see the implementation of CDrawPart::PrintInfoChanged in the ODF Draw sample.
  10.  
  11.  
  12. New Methods:
  13.  
  14. virtual void FW_CPart::PrintInfoChanged(Environment *ev, FW_CPrintInfo* printInfo);
  15.  
  16. This method is called when the FW_CPrintInfo object is created, after the page setup dialog is confirmed, and after the print job dialog is confirmed. This allows the part to make changes based on the current page settings. The base class implementation does nothing.
  17.  
  18. -------
  19.  
  20. Boolean FW_CPrintInfo::GetPrinterResolution(long& hRes, long& vRes);
  21.  
  22. This method returns, in hRes and vRes, the current resolution of the FW_CPrintInfo in dots per inch.
  23. Returns true if successful and false if an error occured.
  24.  
  25. -------
  26.  
  27. Boolean FW_CPrintInfo::SetPrinterResolution(long hRes, long vRes);
  28.  
  29. This method attempts to set the resolution of the printer represented by the FW_CPrintInfo to the specified horizontal and vertical resolution.
  30.  
  31. Returns true if successful and false if an error occurred, such as if the printer doesn't support the specified resolution.
  32.  
  33. Note: The ODF Release 2 implementation returns an error if an attempt is made to set the resolution to any value different from the current printer resolution.
  34.  
  35. -------
  36.  
  37. FW_CRect FW_CPrintInfo::GetPaperBounds();
  38.  
  39. This method returns a rectangle representing the paper dimensions of the FW_CPrintInfo. This will usually be larger than the rectangle returned by GetPageBounds(), which represents the imaging dimensions. It is in the same coordinate system as GetPageBounds(), which will usually return a rectangle with its origin at 0,0.
  40.  
  41. In order to determine the actual size of the image, it is necessary to use the current printer resolution which may be obtained via FW_CPrintInfo::GetPrinterResolution().
  42.  
  43.  
  44.  
  45. Methods that are now public:
  46.  
  47. FW_CPrintInfo *FW_CPrintHandler::GetPrintInfo();
  48.  
  49. This method was formerly private to FW_CPrintHandler(), but is now available so that parts may more easily access printer information. It is not advisable to directly access information in the FW_CPrintInfo object.
  50.  
  51.  
  52. © 1993 - 1996 Apple Computer, Inc. All rights reserved.
  53. Apple, the Apple Logo, Macintosh, and OpenDoc are trademarks of Apple Computer, Inc., registered in the United States and other countries.